package com.amos.muexamclient.security.service;

import com.amos.muexamclient.sys.service.dto.SysUserDTO;

import java.util.Set;

/**
 * Copyright © 2018 嘉源锐信. All rights reserved.
 *
 * @Project: mu-exam
 * @ClassName: PermissionService
 * @Package: com.amos.muexamclient.security.service
 * @author: zhuqb
 * @Description:
 * @date: 2020/3/25 0025 下午 16:47
 * @Version: V1.0
 */
public interface PermissionService {
    /**
     * 验证用户是否具备某权限
     *
     * @param permission 权限字符串
     * @return 用户是否具备某权限
     */
    boolean hasPermi(String permission);

    /**
     * 验证用户是否不具备某权限，与 hasPermi逻辑相反
     *
     * @param permission 权限字符串
     * @return 用户是否不具备某权限
     */
    boolean lacksPermi(String permission);

    /**
     * 验证用户是否具有以下任意一个权限
     *
     * @param permissions 以 PERMISSION_NAMES_DELIMETER 为分隔符的权限列表
     * @return 用户是否具有以下任意一个权限
     */
    boolean hasAnyPermi(String permissions);

    /**
     * 判断用户是否拥有某个角色
     *
     * @param role 角色字符串
     * @return 用户是否具备某角色
     */
    boolean hasRole(String role);

    /**
     * 验证用户是否不具备某角色，与 isRole逻辑相反。
     *
     * @param role 角色名称
     * @return 用户是否不具备某角色
     */
    boolean lacksRole(String role);

    /**
     * 验证用户是否具有以下任意一个角色
     *
     * @param roles 以 ROLE_NAMES_DELIMETER 为分隔符的角色列表
     * @return 用户是否具有以下任意一个角色
     */
    boolean hasAnyRoles(String roles);

    /**
     * 判断是否包含权限
     *
     * @param permissions 权限列表
     * @param permission  权限字符串
     * @return 用户是否具备某权限
     */
    boolean hasPermissions(Set<String> permissions, String permission);

    Set<String> getRolePermission(SysUserDTO user);

    Set<String> getMenuPermission(SysUserDTO user);
}
